Objective

Refactors the entire rotation and orientation system to use quaternion-like Rotary instead of raw angles for 2D rotations. This provides more robust mathematical operations, eliminates angle wrapping issues, and creates consistency between 2D and 3D rotation handling.

Solution

• Orientation2D now uses Rotary instead of Angle
• Added Rotary.slerp() for smooth interpolation

Showcase

The new Rotary-based system provides more robust rotation handling:

// Creating orientations with Rotary
const orientation = new Orientation2D(Math.cos(angle), Math.sin(angle))

// Rotating objects properly
orientation.multiply(Rotary.fromAngle(QUARTER_PI * delta))

// Smooth interpolation between rotations
Rotary.slerp(startOrientation, endOrientation, progress)

Migration Guide

Orientation2D is no longer an Angle but a Rotary.Orientation operations should be switched from using number based angles to Rotary operations.For examole:

• Rotating an entity:

// before:
orientation.value += rotationSpeed * deltaTime

// after
orientation.multiply(Rotary.fromAngle(rotationSpeed * deltaTime))

// Or for direct angle assignment
orientation.copy(Rotary.fromAngle(desiredAngle))

• Getting the angle of the entity:

// before
const angle = orientation.value

// after
const angle = Rotary.toAngle(orientation)

• Interpolation of orientation:

// before
Angle.lerp(startAngle, endAngle, t)

// after
Rotary.slerp(startOrientation, endOrientation, t)

Checklist

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.